Inside Macintosh: QuickTime Components /

Chapter 9 - Movie Data Exchange Components / Movie Data Exchange Components Reference

Configuring Movie Data Import Components /

MovieImportSetSampleDescription

The MovieImportSetSampleDescription function allows an application to provide a sample description to your movie data import component.

pascal ComponentResult MovieImportSetSampleDescription
                                 (ComponentInstance ci,
                                  SampleDescriptionHandle desc, 
                                  OSType mediaType);

ci

Identifies the application's connection to your movie data import component.

desc

Contains a handle to a sample description. Your component must not dispose of this handle. If you want to save any data from the sample description, be sure to copy it at this time.

mediaType

Specifies the type of sample description referred to by the desc parameter. If the desc parameter refers to an image description structure, this parameter is set to VideoMediaType ('vide'); for sound description structures, this parameter is set to SoundMediaType ('soun').

DESCRIPTION

Applications may use the MovieImportSetSampleDescription function to supply a sample description to your movie data import component. This can be useful in cases where your component must transform the data before adding it to the movie's media. For example, your component may be responsible for adding image data to a movie. In this case, you may allow applications to specify image-compression parameters by supplying a formatted image description structure.

RESULT CODE

badComponentSelector

0x80008002

Function not supported

Main | Top of Section | What's New | Apple Computer, Inc. | Find It | Feedback | Help